LogMeIn Hamachi2 for Mac User Guide
===================================

About LogMeIn Hamachi2

	LogMeIn Hamachi2 is a virtual networking service that can be set up in 
	minutes and enables secure remote access to your business network 
	anywhere there is an Internet connection.

	Unlike traditional hardware and software based VPN systems, LogMeIn
	Hamachi2 is an on-demand virtual networking service that allows you to
	focus your time and energy on providing the remote connections your 
	users and systems need, and not the technology or infrastructure you 
	are using to support them.

	For more information, visit 
	https://secure.logmein.com/US/products/hamachi2/


Quick Start

	To install LogMeIn Hamachi2 and join a network, do the following:

	1. Install LogMeIn Hamachi2 as described in the Installation section.

	2. Run 'hamachi login' to set the daemon online and to create an account.

	3. Optionally, run 'hamachi set-nick <nickname>'. Unless you select a
	   nickname, other Hamachi2 peers will see your client name as blank.

	4. Run 'hamachi join <network id>' to join a network.

	5. Run 'hamachi list' to list network members and their status.

	
Installation

	The Hamachi2 Mac client comes as a single executable package. This 
	package includes the setup utility.

	To install LogMeIn Hamachi2, do the following:

	1. Double-click on the DMG package that you have downloaded from the 
	LogMeIn	website. 
	
	2. Double-click on the PKG file to start the installation.

	3. On the Introduction page, click Continue.

	4. Accept the License agreement on the License page and click Continue
	   until you get to the Installation page.
	
	5. On the Installation page, you must enter your username and password 
	   then click Continue.

	6. Click Install to start the installation process. 


Starting the Hamachi2 Client

	After the daemon is started, you can control the Hamachi2 client from the
	command	line as follows:

		hamachi [command]
	
	When you run the daemon for the first time, it stays offline. To change
	its status to online, run:

		hamachi login

	To change its status back to offline, use:

		hamachi logout

	Running the Hamachi2 daemon without an argument displays the daemon's
	status:

		version    : 2.0.0.8
		pid        : 956
		status     : logging in
		client id  : 087-125-763
		address    : 5.50.1.2
		nickname   : buddy
		lmi account: buddy@net.com
	
	Note that the daemon remembers its state when it is shutdown with
	the 'stop' command. So if its state was online, it will automatically
	go online when started next time. If it was offline, it will stay
	offline.
	
	
Hamachi2 Client Commands

	After you have logged in, you can list the available Hamachi2 operations
	with the following command:
		
		hamachi -h
	
	The following network operations are available:
	
	set-nick <nickname>			Changes your nickname.
	
	login 					Changes the client's 
						status to online.
	
	logout 					Changes the client's 
						status to offline.
	
	list					Lists the networks and
						their peers that you 
						are a member of.
	
	peer					Lists the peer properties,
						such as tunnel status and
						authentication settings.
	
	network <network id>			Lists the details of the 
						specified network.

	create <network id> [<password>]	Creates a mesh network.
	
	set-pass <network id> [<password>]	Changes the password of
						your network.
	
	set-access <network id>			Sets the access of networks
	    [lock|unlock] [manual|auto]		of which you are admin 
						(Hamachi1 only) or owner 
						(Hamachi1 and Hamachi2).

	delete <network id>			Deletes your network.
	
	evict <network id> <client id>		Evicts a member from your
						network.
	approve <network id> <client id>	Approves the join request 
						of a client to a network
						created on your Hamachi2 
						client.
	
	reject <network id> <client id>		Rejects the join request 
						of a client to your network
						created on your Hamachi2 
						client.

	join <network id> [<password>]		Joins a network.
	
	do-join <network id> [<password>]	Sends a join request to a
						network that requires
						manual approval.
	
	leave <network id>			Leaves a network.
	
	go-online <network id>			Goes online in a network.
	
	go-offline <network id>			Goes offline in a network.
	
	attach <LogMeIn account>		Attaches your client to a
						LogMeIn account. 
	
	attach-net <LogMeIn account>		Attaches your client with
						all the networks that you
						have created to a LogMeIn
						account.
	
	cancel					Cancels a pending attach
						request.
		
	check-update				Checks if Hamachi2 client 
						updates are available.


	For detailed description of the Hamachi2 client commands, see the
	following sections.
	
	
Joining Hamachi2 Networks

	You can join networks using the 'hamachi join' command. You will be 
	prompted for the password if it is not specified with the command.

	To join a network that requires manual approval of the owner, use the 
	'hamachi do-join' command.
	
	
Creating and Managing Your Hamachi2 Networks 
	
	You can also create your own networks using the 'hamachi create' command.
	You will become an owner of any network that you create and only you
	will be able to delete these networks with the 'hamachi delete' command.
	
	With the 'hamachi evict' command, you can remove unwanted members from 
	the networks that you own.
	
	Note that you will stay online in the network after you create or
	join it. To go offline in the network, use the 'hamachi go-online' 
	command.

	Two other commands, 'hamachi go-offline' and 'hamachi leave', reverse
	the effect of the 'hamachi go-online' and 'hamachi join' commands 
	respectively.

	Note that the daemon remembers your network state. If you logout or 
	shutdown the daemon while being online in a network, the daemon will 
	automatically put you back online in the network on the next logon.
	

Attaching Your Client and Networks to a LogMeIn	Account

	You can attach your client to a LogMeIn	Account with the 'hamachi attach'
	command. This command sends an attach request to the LogMeIn account
	holder who must approve or reject your request. Until the LogMeIn account
	holder sends a response, you can cancel your request with the 'hamachi
	cancel' command. 
	
	If you want to attach your client with all the networks that you have 
	created on the client, use the 'hamachi attach-net' command.
	
	
Listing Peers

	To view the list of all networks and their members, run:

		hamachi list

	Network IDs are enclosed in square brackets and the network names are in 
	apostrophes. For gateway networks, the IP of the Hamachi2 network adapter
	and network mask is also displayed. The asterisk (*) in front of the 
	network name means that you are online in that network:

	* [023-715-571]  'abcde'
	* [system.gw]		 [192.168.4.3/24]
	    091-123-894  george  5.11.12.2
	* [homelan]   
	  * 087-455-651  chris   5.10.0.15    direct      UDP    65.49.88.5:7650
	  x 095-157-685  ronny   5.10.0.16    direct      UDP    45.234.5.1:1045
	    095-571-486  jane    5.10.0.17    direct      UDP    97.34.3.7:3450
	  * 096-654-987  jill    5.10.0.18    via-relay   UDP    144.6.89.12:5100
      
	Under the network name, there is a peer list. Online peers will have
	their IP address prefixed by an asterisk (*) or an (x). 

	(*) means that the tunnel to the peer is either being established or
	    ready. In the latter case, the peer's tunnel address is shown 
	    on the right side of the list.

	(x) means that the peer in unreachable, because the mediation server 
	    either failed or is still trying to establish p2p tunnel between you
	    and the peer.

	The first column of the peer list contains the nine-digit peer client ID.
	
	The second column contains the nickname of the peer.
	
	The IP address in the third column denotes the Hamachi2 IP address of the 
	peer that is used to connect to other peers.

	The connection type of the peer is marked in the next column as follows:

	direct:      Other peers can make direct peer-to-peer connection, which is 
		     the fastest connection type.
	via-relay:   There is no direct connection between peers. Instead, peers 
		     connect to the dedicated relay server that handles connection
		     and transfers packages to the peers.
	via-server:  Peers cannot establish connections to relay servers and
		     therefore packages are transferred via the server connection. 
		     This is the slowest connection type.

	The next column indicates whether the peer can establish UDP or TCP 
	connection.

	The last column contains the physical IP address of the peer (if known)
	that Hamachi2 uses to establish connection between the peer and the
	Hamachi2 network adapter.



Listing Peer Properties
	
	To list peer properties, enter the following command:

		hamachi peer <client id>

	You see the following list of peer properties:

		client id  : 087-455-651

		nickname   : chris
		connection : direct
	
		authentication : completed
		encryption     : enabled
		compression    : disabled
		VPN status     : ok
		address        : 65.49.88.5
	
		via server  ok       TCP  n/a
  
	      * direct      ok       UDP  192.168.2.123:61200

	These peer properties contain similar information to those that you see 
	in the peer list. The 'VPN status' field denotes whether the Hamachi2 
	virtual adapter is configured correctly, while the 'address' field 
	contains the Hamachi2 virtual IP address of the Hamachi2 peer. The 
	'direct' line contains the physical IP address of the Hamachi2 peer. 

	The last two lines show the connection to the peer. The active connection 
	is marked with an asterisk.


Listing Network Properties

	To get detailed information about a specific network, enter the following
	command:

		hamachi network <network id>

	You see the following list of network properties:

		id       : 091-123-894
		name     : abcde
		type     : Gateway

		VPN status  : ok
		IP address  : 192.168.1.33/22

	Important: Only Windows and Linux clients can act as gateways in a 
	gateway network. Mac clients can only be members of such networks.

	Network properties contain similar information to peer properties. The 
	network type can be Mesh, Hub-and-Spoke, and Gateway. If the network is 
	of gateway type and has static configuration, additional information is 
	also displayed about the start and end IP range, DNS servers, remote 
	networks, the default gateway and domain name. Gateway networks with 
	DHCP configuration do not contain additional information.

	For those networks that were created on the client, an 'Owner' field is
	also displayed. This field contains the client ID of the owner of the 
	network.


Changing Nicknames
	
	You can change your own nickname with the 'hamachi set-nick' 
	command when you are online.


Changing Network Passwords

	To change the password of a mesh network that you created enter the
	following command:

		hamachi set-pass <network id> [<password>]

	There are no password strength requirements in LogMeIn Hamachi2.


Managing Network Access

	To set the access of a network that you have created on the Hamachi2
	client, enter the following command:

		hamachi set-access <network id> [lock|unlock] [manual|auto]

	To prevent clients from joining your network, use the 'lock' 
	option:

		hamachi set-access 023-715-571 lock
	
	In this case, join reqests will be automatically rejected.

	To enable new members to join your network, use the unlock option 
	on a locked network. This is the default setting, therefore all new 
	networks can accept new members.

	To approve the join request of new members, you can choose manual and 
	automatic approval:

		hamachi set-access 023-715-571 manual

	Clients that are waiting for manual approval to join your network are
	listed with a question mark (?) in front of the client ID.

	To accept a join request, you must define the client that you want to 
	accept and the network that the client wants to join to:

		hamachi approve <network id> <client id>


==================================================================================
Copyright © 2019 LogMeIn, Inc. All rights reserved.